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Making FileMaker “External Functions” 


By Joe Kroeger 

There have been comments in these pages over 
the years about some of the drawbacks of FileMaker. 
But much more often we have discussed—directly 
and indirectly—the wonderful and productive ver¬ 
satility of the FileMaker database. Our motto “If it 
can’t be done with FileMaker it’s not worth doing” is 
intended not only to be a little humorous and to 
portray an attitude — it also says a lot about the actu¬ 
al reality of the product. The originators of FileMak¬ 
er were able to create a fundamentally good 
foundation that has brought us many features to 
which we have become addicted. When Claris ac¬ 
quired FileMaker, they built on that good base and 
took it even further in the right directions. Among 
other enhancements, FileMaker scripting has been 
moved from a minor and modest role into a serious 
and important tool. 

The new, more powerful scripting capabihties 
that appeared starting with the first FileMaker Pro 


j have opened up a whole world of new ways to make 

I use of FileMaker. Note that Claris, those clever 
I devils, provided not only new scriptingfeatures for 
I us, but also provided good user access to those fea- 
j tures — extending what is also true for most of the 

I 

I rest of the product. FileMaker scripting has come a 
I long way from the early days when a script could 

I only remember some of the last actions taken by the 

I user. There are still a few scripting areas where im- 
I provement would be welcomed and it is my guess 

I that Claris is working to add new capabilities. (I also 
I hope that Claris is teaching Apple something about 
building a user interface for scripting so that Apple- 
Script will improve.) 

Scripting improvements in FileMaker contribute 
to significant broadening of what our motto calls 
“worth doing”. And each new feature makes the 
motto even more true than it was before. We’ve 
discussed before some of the techniques for using 
scripting to solve database problems, and there will 
be more such articles in the future. 
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All of which serves to introduce another | 

way—new to me — to take advantage of | 

scripts, and a new way to use combinations of 
FileMaker files. This approach has been made j 

I 

possible by new scripting capabilities. It is my | 
opinion that this technique opens up a wide | 
range of new possibilities, offering new ways to I 

solve existing problems and good solutions to 
brand new problems. This issue of the newslet¬ 
ter introduces the concept and includes a few 
examples of how the idea can be used. I expect 
we’U be talking more about it in the future. 

I 

Multi-file Arrangements | 

There are already several types of file link¬ 
ages that we’re accustomed to using. An obvi- | 
ous and quite powerful one is a lookup file. i 

Figure 1 shows the generic setup. Once a key | 

field has been defined and source/destination | 

fields have been specified, the lookup link is j 

established and can then be exercised as de- I 
sired, either on one record in the destination j 
file or on many. In Figure 2 the five-digit ZIP | 
code is used as a lookup key that triggers trans- | 

fer of City and State information into the Ad¬ 
dress file. The lookup capability is built into | 

FileMaker and allows quite powerful operating | 
arrangements to be implemented. | 

One of the characteristics of a lookup is | 

that it permits files with radically different | 

answers to that primal question “What is a | 

record?” to nonetheless communicate. Com- | 

plex networks of lookups can be constructed. | 

Figure 3 shows an example. | 

Another way information can be moved j 
between files is to import records from one to } 
the other. The setup is easy—links need not be I 

established. Mapping incoming fields to desti- I 

I 

nation fields is needed, but will sometimes be | 

automatic. Mappings can be captured in | 

scripts so that subsequent repetitive imports | 
can be automated. j 

Two files with similar record definitions | 

can be “synchronized” so that they act together | 


as if they are a single larger 
lookup file. Figure 4 shows 
an example. One field con¬ 
taining unique information is 
common to both files 
(NameCode in this case). 

The fields that pertain to that 
NameCode are divided so 
that some are in one file and 
some in another. It is as if a 
larger record was split into two sub-records. 

This scheme works well (but it is important to 
be careful about maintaining the one-to-one 
correspondence between linked records) and I 
have used it to over¬ 
come record count and 
file size limitations for 
very large lookups. 

In issue #55 the 
newsletter covered an 
inventory example 
where information 
from one file was used 
to update information 
in another file. File- 
maker scripting was the tool that transfered the 
data for the updating. The ability to, from one 
file execute a remote script in another file is the 
key to this kind of operation. We’ll use this 
some more. 

ro 

£ 
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I 

Similarly, let’s say you have an order entry j 

file that is supported by a lookup file contain- | 

ing names and addresses of customers. When | 

you enter an order and there are changes to be | 
made in the address, how do the changes get | 

processed back to the lookup file to update if? I 
In the old days we might have opened the look- | 
up file while entering the order, made the nec- j 

essary changes, and returned to the order-entry j 
process to look up the fixed address. A little | 

messy. Or we might have periodically sent all j 
the order addresses to be processed later off- | 
line against the lookup addresses, and then | 
constructed a new lookup. With today’s script- | 
ing, however, the address revisions can be 1 

made in the order entry file, and a button j 

cHcked to cause the old address in the lookup 
file to be updated to the new version. 





What are "External Functions"? 

The new idea of external FileMaker func¬ 
tions involves a linkage between files that is 
different than any of these examples. Indeed, 
the second file, outside the main working file, 
can be thought of as not a conventional file at 
aU. It acts instead like a stand-alone external 
function — a separate chunk of software that 
augments the operation of the main fiile. We’re 
simply using FileMaker as a vehicle to create 
that chunk of code. We are not using FileMak¬ 
er as a database. 

The basic structure of this idea occurred to 
me while contemplating the monster calcula¬ 
tion from issue #54 (“Calculating Word Equiv¬ 
alents of Numbers”). Some readers were happy 
to have a calculation, however brute force, that 
solved a problem for them. But there were also 
a couple of complaints from readers and I was 
wondering how it might be easier for a File¬ 
Maker user to make use of complex calcula¬ 
tions like this one. The drudgery for the user 
involves copying exactly an equation that may 
be quite long and messy into an existing file, 
testing the result, repairing any mistakes, and 
so forth. (We’ve been selling an electronic 
version of the equation from #54 to help bypass 
some of this effort.) 

At around the same time as I was contem¬ 
plating this problem, two clever consultants 
submitted different calculations that they had 
been using to accomplish similar numeric-to- 
text conversions. Since both were improve¬ 
ments over the one in issue #54,1 was tempted 
to run them in a future issue. But that would 
again drive many subscribers into the copying 
drudgery. 

The better way that occurred to me is that 
the equation does not need to live in the target 
file! With scripting it might be possible to let a 
long and cumbersome calculation exist outside 
the file that uses it. It would then be easier for 
users to make a script that refers to the external 
calculation rather than attempt to build the 
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equation itself into the file that uses it. I tried | 

out this idea and by golly it actually works! I 

The general idea is shown in Figure 5 (pre- | 

vious page). Note the similarity to Figure 1, | 

except that scripts are moving data to-and- | 
from the cfipboard. When the appropriate | 
script in the main file is executed (perhaps by | 

cHcking on a button), the value in an internal | 
field is copied to the clipboard, pasted into a | 
field in the external file, a calculation is per- f 
formed, and the external result is copied to the | 
cHpboard and pasted back into a field in the I 
main file. For details, see the following two | 

articles in this issue. | 

The more I thought about it the more it | 

f. 

seemed to me that there must be other prob- | 
lems that this approach might help solve. A few | 
days later, in the process of working on another I 
project, I came across an operation that is j 

solved nicely this new way: capitalizing text. A I 

I 

separate article in this issue describes a way to | 
do so with an external function. | 

i 

g 

Variations | 

I think there must be many different ways | 

to make use of this approach. More than one | 

variable, for example, could be sent to the out- j 

side file for special evaluation or to control the I 
calculation. | 

A series of (perhaps related) fiinctions in | 
an external file could be accessed by different | 

scripts. If we had an opportunity within a script | 
to test a value that had been copied from a field I 
and then make a decision based on that test, I 
the versatility of scripting would explode. With | 

such a capability, several alternate functions I 
could be accessed using only one script in the | 

main file. Meanwhile, multiple scripts will | 

often do the job. j 

The external function can sometimes be | 

used to lighten the load on the scripting re- | 
quired. This will be especially valuable when | 

the external file is being used as a vehicle for | 
distributing functions to users. Some of the | 


decision process 
can be moved out 
to the external 
function file. Con¬ 
sider the example 
in Figure 6. The 
controlling script 
would move two 
parameters to the 
external file which 
would then per¬ 
form the appro¬ 
priate calculation. 

Information in the 
Control In field is used by the calculation to 
make the appropriate result available in the 
Data Out field. 

You might use this approach to build your 
own “smart” lookup table that changes charac¬ 
teristics at the flick of a script. Consider an 
external function that calculates precision 
trigonometric results. Rather than build a big 
lookup that includes all possible high-precision 
values of, say, both sine and tangent (potential¬ 
ly a very large table), just set up a lookup that 
generates a small set of values around a base 
parameter that is put in place by the initiating 
script. 

Instead of having just one result returned 
to the main file, it 
would often be 
possible for the 
external function 
to generate several 
fields-worth of 
data. Figure 7 
shows how an 
external function 
might be used to 
extract, for exam¬ 
ple name compo¬ 
nents from a 
FullName field. 

(The calculation 



v 
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to do so can easily be quite complex.) 

I think there are probably many, many 
ways to take advantage of this general ap¬ 
proach. Please let me know if you have some 
ideas of other ways to use external functions. 
And if you have some neat functions that could 
be distributed to users this way, send in your 
idea to The FileMaker Annex. 

The Basic Idea 

In general, some of the most creative and 
unusual uses for FileMaker require looking at 
the program from a different angle. The tech¬ 
nique discussed in this article is no exception. 

It is based on the idea that a FileMaker file need 
not (gasp) be strictly a database! It can be a 
repository for a wide variety of elements that 
are useful adjuncts to databases. FileMaker 
scripting allows us to move parameters to con¬ 
venient locations where they can be operated 
on and the results returned to the home file. 


Does moving a large calculation outboard make a file 
smaller? I set up a test to find out. I took an address file 
with 17,255 records, 28 non-calculation fields, 17 
calculation fields, 2 layouts, and 11 scripts. I com¬ 
pressed it. This version of the file then consumed 
7,662,592 bytes. I made a copy of the file, deleted a 
long (1160 character) calculation, and then com¬ 
pressed it. The new version of the file then consumed 
7,513,088 bytes. This represents a decrease of less than 
2%. My conclusion is that file size differences are 
pretty modest and will not generally be a motive for 
moving calculations to external functions files. 


Characteristics and Comments 

• This external function methodology pro¬ 
vides an easy way for users to implement com¬ 
plex functions without building the functions 
themselves. 

• This technique is not limited to imple¬ 
menting complex functions. The external func¬ 
tion itself in the case of the capitalization 
example is quite simple (although the script 
that drives it can be a little involved). 

• This technique provides a means for con¬ 
sultants and developers to distribute complex 
functions that can be easily integrated into 
their clients’ databases. 

• This technique appears to allow password 
protection of selected portions of a database 
that might be difficult to shield with regular 
FileMaker protection. 

• The impact on file size of this technique 
seems to be minimal, especially after adding 
back the size of the external file. 

• One of the attractive features of the Pan¬ 
orama database is that calculations can be tran¬ 
sient and local; that is, they can be entered 
on-the-fly and designated to operate only on 
the found set. External functions allow the 
same kind of operations to be implemented in 
FileMaker. You may need a function only tem¬ 
porarily, such as when doing a one-time 
extraction of information from a subset of 
newly-imported records. 

• External functions may be slow for some 
operations, especially serial sequences. 

-A/- 
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Another Number-to-Text Conversion 


By Glenn Nunez 

I 

J-N ISSUE ^4 of The FileMaker Reportthelead I 

article “Calculating Word Equivalents of Num- | 
bers” presented an interesting equation that con- | 
verts numeric values into their text equivalents. | 

The author clearly states that he took a “brute I 

force” approach for his solution and the calcula¬ 
tion makes a reasonable start within that context. 1 

I want to present a more powerful approach to 1 

the equation which I have developed over the last ] 

two or three years. I based it on a technique I first 
saw in the Claris Technical Solutions magazine of j 
March 1990. Since then I have taken the basic I 

idea to a greater level of usefulness for for my # 

clients’ applications. 

You may, of course, name the input and 
output fields anything that you like. I have used , 
“Numln” and “TextOut” for this article. Here j 
are the enhancements and basic characteristics | 
of my calculation: | 

• The equation in this article is approxi¬ 

mately one-third the size of “WordNum” in 
issue #54 and uses fewer than one-fourth as I 
many If ftmctions. j 

• The most important improvement is a I 

maximum allowable numeric amount of | 

$999,999.99. For many uses, the maximum | 

value contraint of the older equation is a severe | 
restriction. | 

• Alphabetic characters are allowed in the | 

input field. They are ignored in the calculation, | 
but it’s nice to be able to type commas into a | 

number greater than one thousand. | 

I 

• Cents values are converted to “xx/100” I 

I 

followed by the word “Dollars”. If the input | 

field contains no cents value or “00” cents, the | 

word “Exactly” is added as a prefix to the cal- | 

I 

culated text and the cents values are omitted. | 

• Input values may have more than two | 

decimal places. This is especially useful when | 


calculated numeric values form the input. With 
one exception (see the description of If #17 
below), such values are rounded up or down 
appropriately and displayed to two significant 
digits. Cents values less than 10<t are displayed 
with a leading cents zero. 

• Negative values of Numln are not permit¬ 
ted. (If you need to work with negative num¬ 
bers, consider incorporating ABS(Numln) in 
place of Numln in the calculation and concate¬ 
nating something appropriate (“minus”? “neg¬ 
ative”? “-”?) at the beginning of the result. You 
may also have to detect and store the fact that 
Numln is negative.) 

♦ TextOut is calculated in mostly mixed 
case. It is easy, if desired, to change any or all of 
the text in the equation to upper case. 

A Look at the Formula 

Here it is! The customary caret, has 
been substituted for each required soft space in 
the printed version of the equation — you must 
substitute a soft space (spacebar) for each caret 
when entering the equation into FileMaker. 
Note that the numbers of spaces within the text 
expressions, especially those in each Middle 
function, are critical for proper calculation. 

For a numeric field Numln, the formula 
for a text field TextOut is shown in the left 
column on the next page. 

Yes, it looks fairly complicated, but with a 
little perseverance the equation can be reduced 
to comprehensible components. The calcula¬ 
tion relies heavily on four FileMaker functions: 
Int, Mod, Trim, and Middle. Readers not 
fami li ar with these functions should consult 
the FileMaker Pro User’s Guide. Various arti¬ 
cles in past issues of The FileMaker Report have 
discussed these functions. 
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Te)rtOut = 

If (Numln < 0 or Numln > 1000000, "INVALIDaaMOUNT'', 

If (Mod (Numln, 1) > .005,"Exactly*") & 

If (Numln > 1, If (Int (Numln /100000), 

Trim (Middle (''One**Two**ThreeFour*Five*Six**Seven 
EightNine*", Int (Numln /100000) * 5 - 4,5)) & 

If (Int (Mod (Numln, 100000) /1000), ''*Hundred*", 
"*Hundred*Thousand" & 

If (Mod (Int (Numln), 100000), "*","")),"") & 

If (Int (Mod (Numln, 100000) / 1000), 

If (Int (Mod (Numln, 100000)/1000) > 19, 

Trim (Middle (''*******Twenty*Thirty*Forty**Fifty** 
Sixty**SeventyEighty*Ninety*", 

Int (Int (Mod (Numln, 100000) /1000)/10) * 7 - 6,7)) & 

If (Int (Mod (Numln, 10000) /1000), "") & 

Trim (Middle ("*****0ne**Two**ThreeFour*Five*Six** 
SevenEightNine*", 

Mod (Int (Mod (Numln, 100000) /1000), 10) * 5 + 1,5)), 

Trim (Middle ("One******Two******Three****Four***** 
Five*****Six******Seven****Eight****Nine***** 
Ten******Eleven***Twelve***Thirteen*Fourteen*Fifteen** 
Sixteen**SeventeenEighteen*Nineteen*", 

Int (Mod (Numln, 100000) /1000) * 9 - 8,9))) & "*Thousand" & 

If (Mod (Int (Numln), 1000), "*",""),'"') & 

If (Int (Mod (Numln, 100000) / 1000) or Mod (Int (Numln), 1000) 
or Mod (Int (Numln), 100000) = 0,"*") & 

If (Int (Mod (Numln, 1000)/ 100), Trim (Middle ("One**Two** 
ThreeFour*Five*Six**SevenEightNine*", 

Int (Mod (Numln, 1000)/100) * 5 - 4,5)) & "^Hundred" & 

If (Mod (Int (Numln), 100), "*",""),"") & 

If (Int (Mod (Numln, 100)) > 19, Trim (Middle 
("*AAAAAA7vventy*Thirty*Forty**Fifty**Sixty**Seventy 
EightyANinetyA", Int (Int (Mod (Numln, 100))/10) *7 - 6,7)) & 

If (Mod (Int (Numln), 10), "*","") & Trim (Middle 
("AAAAAOneAATwoAAThreeFourAFiveASixAASevenEightNineA”, 
Int (Mod (Numln, 10)) *5 + 1,5)), Trim (Middle 

("AAAAAAAAAOneAAAAAAJyyoAAAAAATfireeAAAA 

FOUrAAAAApjy0AAAAASjxAAAAAA50V0f|AAAA^gf^-tAAAA|\jjn0AAAAA 

TenAAAAAAp|0v0nAAAJw0|v0AAAJ|^jrt00nApQ0rt00nApjft;00pAA 

SixteenAASeventeenEighteenANineteenA", 

Int (Mod (Numln, 100)) * 9 + 1,9))), "Zero") & 

If (Mod (Numln, 1) > .005, "AandA" & 

If (Mod (Numln, 1) > .995, "99", Right ("0" & 100 * Round 
(Mod (Numln, 1), 2), 2)) & "/100","") & "ADollar" & 

If (Numln < 1 or Numln > 1.005, "s","")) 


I The easiest way to interpret the calculation 
I is to analyze each of the If functions separately. 

I Because some of the functions with their para- 
I meters are quite long and several are nested or 
I otherwise interdependent, full analysis can take 
I some time. Patience is a virtue if you want to 

I imderstand the details. For reference, a version 
j of the equation is included on page 9 that has 

I numbers inserted in curly brackets. The brack- 

I eted numbers are not part of the equation but 
I are reference points for the descriptions that 

i follow. 

I 

I Calculating the Words 

I Of the eighteen If functions in the calcula- 

j tion, only four are used for the actual number- 
I to-text conversions. The simplest of these. If 

I #4, deals with the hundred-thousands place. If 
I #8 extracts the ten-thousands and thousands 
j places. If # 12 takes care of the hundreds place 

I while the last, #14, handles the tens and ones 
1 places. 

Dissecting one of these functions is an 
interesting exercise. Let’s take a look at If #12: 

j If (Int (Mod (Numln, 1000)/100), 

I Trim (Middle ("OneAATwoAAThreeFourAPiveA 
SixAASevenEightNine^", 
j Int (Mod (Numln, 1000) / 100) * 5 - 4,5)) & 

I "AHundred" & 

1 If (Mod (Int (Numln), 100), "a", ""), "") 

I We’ll use $987,654.32 as a sample value for 
Numln. If #12, which analyzes the hrmdreds 
place, should give the result “Six Hundred ”. 
j Let’s follow the sample value as it flows 
j through this If function: 

j • If (test, result one, result two) 
j • If (Int (Mod (Numln, 1000) / 100), result one, 
j result two) 

I • If (Int (Mod (987654.32,1000) / 100), result 
I one, result two) 

• If (Int (654.32 / 100), result one, result two) 

• If (Int (6.5432), result one, result two) 

• If (6, result one, result two) 
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Note that the FileMaker formula 
“If (6, result one, result two)” 
is equivalent to 

“If (6 ^ 0, result one, result two)”. 

This makes a convenient shortcut at times. 

If our sample value for Numln had been 
$987,054.32, the test would have been false and 
we would have used the blank ("") in result 
two. But since “6 does not equal zero” is true, 
we use “result one”. 

We thus need to calculate “result one”. The 
last part of this result is the word “^Hundred” 
and, depending on the nested If #13, a space or 
a blank. In our example. If #13 is true so we use 
a space. It is the first part of “result one” which 
now interests us: 

• If (6, result one & "AHundredA","") 

• If (6,Trim (Middle ("OneAATwoAAThreeFourA 
FiveASixAASevenEightNineA", 

• Int (Mod (Numln, 1000) /100) * 5 - 4,5)) 
&"AHundredA","") 

• If (6,Trim (Middle ("OneAATwoAAThreeFourA 
FiveASixAASevenEightNineA", 6 * 5-4,5)) & 
"AHundredA","") 

• If (6,Trim (Middle ("OneAATwoAAThreeFourA 
FiveASixAASevenEightNineA", 26, 5)) & 
"AHundredA","") 

• If (6,Trim ("SixAA") & "AHundredA","") 

• If (6, "Six" & "AHundredA","") 

•If (6,"SixAHundredA","") 

The fourth If (above) shows the signifi¬ 
cance of entering the correct number of spaces 
within each Middle function. Starting at the 
26th position (the “S” of “Six”), the function 
extracts 5 characters (S, i, x, a, a). The Trim 
function then removes the two spaces. Adding 
or omitting even one space will result in some 
strange-looking text. 

The basic idea here is that the FileMaker 
Middle function, which usually refers to the 
contents of a field, can also refer to a constant 
string embedded in a calculation. In this in¬ 


stance, the text string is arranged so that extrac¬ 
tion is exactly five characters long. Words 
shorter than five characters are filled out with 
space characters. The parameters of the Middle 
function which act on the embedded string are 
derived from the Numln value, and the desired 
text is extracted from the string. Claris showed 
us a clever way to use the Middle function. 

The other three conversion functions are 
similar in structure. The last two of them. If #8 
and If #14, are a bit more involved because, 
instead of dealing with simple integer values 
from 1 to 9, they use one half of each If func¬ 
tion to evaluate numbers from 1 to 19 and the 
other half to check numbers from 20 to 99. 

It’s interesting to note that of the remain¬ 
ing fourteen If functions, seven (#6, #7, #9, 

#10, #11, #13, and #15) do nothing more than 
check to see whether or not a space should be 
inserted within a specific combination of 
words. This happens when a zero occurs in the 
middle of a number. Another If function, #5, 
acts like these seven in that it decides whether 
to use the expression “ ARimdredA” or the 
expression “a Hundred a Thousand” depend¬ 
ing on the presence of zeros in the ten- 
thousands and thousands places of Numln. 

A reference version of the calculation with 
each If statement numbered in curly brackets is 
shown on the next page. Do not try to use this 
as a calculation! 

Housekeeping 

Several more If functions take care of some 
basic overhead. If #1 makes sure that the value 
of Numln is greater than zero and less than 
one million. Negative values cause complica¬ 
tions in the calculations and are seldom en¬ 
countered in the types of apphcations in which 
the formula is commonly used. The principles 
employed in the calculation could certainly be 
used on numbers beyond one million, but I 
had to draw the line somewhere. (Very few 
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TextOut = 

{1}lf (Numln < 0 or Numln > 1000000, "INVALIDMMOUNT', 

{ 2 }lf (Mod (Numln, 1) > .005,"Exactly^ & 

{3}lf(Numln>1, 

{4}lf (Int (Numln /100000), Trim (Middle 

("One''''Two'^^ThreeFour*Five''Six''''SevenEightNine^", 

lnt(Numln/100000)*5-4,5))& 

{5}lf (lnt(Mod (Numln, 100000)/ 1000), 

"''Hundred''", "''Hundred'^Thousand" & 

{ 6 }lf (Mod (Int (Numln), 100000), "a", "")),"") & 

{7}lf (lnt(Mod (Numln, 100000)/1000), 

{ 8 }lf (Int (Mod (Numln, 100000) / 1000) > 19, Trim (Middle 
("A AAA A AAjvventy''Thirty''Forty''''Fifty''''Sixty''''SeventyEighty'' 
Ninety''", Int (Int (Mod (Numln, 100000) /1000) /10) * 7 - 6 ,7)) & 
{9}lf (Int (Mod (Numln, 10000) /1000),"") & Trim (Middle 
("AAAAAQneAAjwo''''ThreeFour''Five''Six''''SevenEightNine''", 
Mod (Int (Mod (Numln, 100000) /1000), 10) * 5 + 1,5)), 

Trim (Middle ("OneAAAAAATyyoAAAAAAjhreeAAAApoui-AAAAA 

FiVeAAAAA 5 j)(AAAAAAS 0 v 0 nAAAA£jgh^AAAA|\|jneAAAAA 

TenAAAAAAE|0V0nAAA7yy0|v0AAAThirteenAFourteenA 

FifteenAASixteenAASeventeenEighteenANineteenA", 

Int (Mod (Numln, 100000) /1000) * 9 - 8 ,9))) & "AThousand" & 
{10}lf (Mod (Int (Numln), 1000), "a", ""),"") & 

{11}lf (Int (Mod (Numln, 100000) /1000) or Mod (Int (Numln), 
1000) or Mod (Int (Numln), 100000) = 0,"''") & 

{12}lf (lnt(Mod (Numln, 1000 )/100), Trim (Middle 
("One''''TwoAAThreeFourAFive''Six''ASevenEightNine''", 

Int (Mod (Numln, 1000) /100) * 5 - 4, 5)) & "AHundred" & 

{13}lf (Mod (Int (Numln), 100),'"'),'“') & 

{14}lf (lnt(Mod (Numln, 100)) > 19, Trim (Middle 
("AAAAAAAjw 0 ntyAjhjrtyAFortyAAFjftYAASjxtyAASeventy 
EightyANinetyA", Int (Int(Mod (Numln, 100))/10) *7 - 6,7)) & 
{15}lf (Mod (Int (Numln), 10), "a", '"') & Trim (Middle 
("AAAAAQneAATwoAAThreeFourAFiveASixAASevenEight 
NineA", Int (Mod (Numln, 10)) *5 + 1,5)), Trim (Middle 

|"AAA AAA AAAQpqA AA A A Ayy^QAA AA A Ayi^ 

FiveAAA/\ASjxAAAAAASeVenAAAAFjghtAAAA|\|jn 0 AAAAA 

j 0 nAA A AAAEieven''''''Twelve''''''Thirteen''Fourteen'' 

Fifteen''''Sixteen''''SeveriteenEighteen''Nineteen''", 

Int (Mod (Numln, 100)) * 9 + 1,9))), "Zero") & 

{16}lf (Mod (Numln, 1) > .005, "''and''" 8 i 

{17}lf (Mod (Numln, 1) > .995, "99", Right ("0" & 100 * Round 

(Mod (Numln, 1), 2), 2)) & "/100","") & "''Dollar" & 

{18}lf (Numln < 1 or Numln >1.005, "s","")) 


FileMaker files deal with corporate buyouts or 
I the federal deficit.) If #2 employs the Mod 
i function to attach the word “Exactly” to the 
front of those values of Numln with no cents 
I amount. (The word “Exactly” can follow rather 
i than precede the calculated text; in such a case 
j the function should be moved to the end of the 
equation.) If #3 is used in the rare occurrences 
I of amounts less than one dollar. 

If # 16 takes care of the cents portion of 
Numln: 

If (Mod (Numln, 1) > .005, "''and''" & 

I If (Mod (Numln, 1) > .995, "99", 

I Right ("0" & 100 * Round (Mod (Numln, 1), 2), 2)) 
&"/ 100 ","") 

For values greater than or equal to 0.54 
($.005) the expression “''and''”, the cents 
value itself and the expression “/lOO” are con- 
I catenated to the text. Values less than 0.54 are 
I rounded down to zero cents and thus appear as 
I a blank. If #17 (see below) handles those values 

greater than or equal to 99.54. For values less 
I than 99.54, the Round and Mod functions 
I extract a two-digit value for the decimal por- 
I tion of Numln, which is then multiphed by 100 
to obtain an integer value. If this value is be- 
j tween 14 and 94, the standard check-writing 
j convention is to add a leading zero. Because 
1 FileMaker does not recognize leading zeros in a 
j number format, the Right function is used in 

I conjunction with a text zero to address this 

I 

I convention. 

I If#17 deals specifically with cents values 

I between 99.54 and $1.00. These amounts are 
I displayed as “99/100”. It’s possible to round 

I 

I these values up to exactly the next whole num- 
I ber but this would require either an additional 
I calculation like 

I 

j Numln = If (Mod (FirstNumln, 1) > .995, 

I Int (FirstNumln + .005), FirstNumln) 

I 

I or the insertion of this equation into the main 
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calculation at each of the thirty-one occurrenc¬ 
es of Numln. I wanted to use only one calcula¬ 
tion field and I also figured the likelihood of 
encountering such values was minimal, so I 
elected to round them down to “99/100” in¬ 
stead. 

The last If function, #18, looks for values of 
precisely one dollar to determine whether or 
not to add an “s”. Should the word “Dollar” or 
“Dollars” not be required in the calculated text, 
this final portion of the equation can be omit¬ 
ted. Be sure not to delete the final closing 
parenthesis of the entire calculation. 


There you have it. Use this calculation in 
good health. Let me know what you think of it. 
The Figure on this page shows a range of trial 
values and their associated results. 


Glenn Nunez is an independent FileMaker 
consultant in Oakland, CA. If you have 
database consulting needs (ora FileMaker 
calculation that needs revision’) contact 
him at 510-452-2116. 



t 

1 8 


Records 
10 - 


Serni-sorled 


.005 

.12 

1 

3.14159 

333.33500 

333.33501 
72.612.32 
81,188.75 

95019 

1234567 


Zero and 01 /lOO Dollars 

Zero and 12/100 Dollars 

Exactly One Dollar 

Three and 14/100 Dollars 

Three Hundred Thirty Three and 33/100 Dollars 

Three Hundred Thirty Three and 34/100 Dollars 

Seventy T’wo Thousand Six Hundred Tv^lve and 32/100 Dollars 

Eighty One Thousand One Hundred Eighty Eight and 75/100 Dollars 

Exactly Ninety Five Thousand Nineteen Dollars 

INVALID AMOUNT 




XUi 
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Putting the Num-to-Text Calculation in a File 


By Joe Kroeger | 

T ^ 

If you want to implement the Num-to-Text | 

equation from the previous article in one of | 
your files, there are (at least) three ways to do | 
so: I 

1) Copy the equation (very carefully!) from the | 

printed version here in the newsletter. Verify and | 
debug it before using. j 

2) Buy an electronic copy in a text file of the , j 

calculation from The FileMaker Annex and | 

then copy-and-paste the equation into your file. | 

3) Buy an electronic copy ofthecalculationina | 

FileMaker file (with an appropriate resident | 

script) from The FileMaker Annex, and insert | 

just a new script (and perhaps a button) into I 

your file. | 

The third option is based on the lead article | 
in this issue about external functions. You i 


would need to enter a simple three-step script 
in your main file (see Figure below). The Main 
File script copies to the clipboard the numeric 
value to be translated and then pastes the result 
of the conversion (that has been placed on the 
clipboard) into the destination field in Main 
File. In between those two actions an external 
script is exercized. 

The external file, called Num->Text, in 
t h is case has one record, two fields, and one 
script. The script, called in & out (shown in 
the Figure on the next page) simply pastes from 
the clipboard into the Numln field and then 
copies the result from the TextOut field to the 
clipboard. It is this external script that the 
script in the main file must trigger. The equa¬ 
tion from the Nunez article that does the actual 
conversion lives in the TextOut field. 

The main file is called Main File. It con- 


Script Definition for “Conuert Num” 
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tains a field called Value that holds the numer- | 
ic data to be converted. Value might have | 

manually-entered data or it could contain the | 
result of a calculation. The Main File also has a | 
text field called WordedValue where the result | 

ofthe conversion will be stored. | 

Here is the overall sequence of events for | 

this operation: I 

1) A numeric value arrives in the Value field in | 
the Main File. I 

2) The CONVERT num script in the Main File is | 

initiated. | 

3) CONVERT NUM copics to the clipboard the I 

contents of the Value field. | 

4) CONVERT NUM opens the Num->Text file | 

and triggers the in & out script in that file. i 

5) IN & OUT pastes the clipboard value into the | 

Numln field in the Num->Text file. i 

I 

6) IN & OUT copies the TextOut field in the I 

Num->Text file to the cfipboard. I 


7) Back in the Main File, convert num pastes 
the clipboard into the WordedValue field. 

This sequence is not as complex as it may 
sound. The user need only enter the convert 
NUM script into their file. A button might be 
used to initiate the operation. Be sure to test, 
test, test with a range of values so that you have 
confidence that the conversions are going the 
way you want them to. 

If you want to do the conversion to all the 
records in a found set, just add two more steps 
to the Main File script. For details see the next 
article about capitalization. 

Note that this is a way for users to put this 
complex calculation into their files without 
entering a long equation and without even 
knowing the details of how it works. 



























Capitalizing Text with an External Function 


By Joe Kroeger 

I DO A LOT OF WORK with address files and that 
includes importing addresses from outside 
sources. I store all the addresses in upper case 
but sometimes imported addresses arrive in 
mixed case. There are several methods I use to 
capitalize them, depending on the circum¬ 
stances. I might export the data to a word pro¬ 
cessor and capitalize everything there (while at 
the same time taking the opportunity to change 
some words to their abbreviations, to remove 
punctuation, and so forth). I might calculate 
upper-case versions of the appropriate fields in 
an incoming database and import only the 
desired fields. 

Now I’ve added a new tool to my kit; an 
external function that capitalizes. This is yet 
another way to take advantage of the method¬ 


ology outlined in the lead article in this issue. 

I use this “Capper” technique when I am 
absorbing just a few addresses or when mixed- 
case records represent just a few records in a 
larger set or when I run across an old record 
that somehow never got capitalized. (Or when 
I enter a whole record after forgetting to turn 
on the caps lock key!) 

To set up this new capitalizing capability, I 
created an external file that I called Capper. It 
has one record, two fields, and one script. The 
fields: Datain and DataCap. The script in 
Capper in my design is called pastein/copy- 
ouT and simply pastes firom the clipboard into 
the Datain field and then copies the result 
from the DataCap field to the clipboard. It is 
this pastein/copyout script in the Capper file 
that the script in the primary address file must 
stimulate as part of the capitalization process. 


Script Definition for “Make Fiue CHPs” 


Available Steps 


"Make FiveCAPs" 


Perform Script [...] 

Pause/Resume Script 


♦ Copy [Select, "FirstName"] 

♦ Perform Script [Sub-scripts, External: "Capper"] 

♦ Paste [Select, "FirstName") 

♦ Copy [Select, "LastName") 

♦ Perform Script [Sub-scripts, External: "Capper") 

♦ Paste [Select, "LastName") 

♦ Copy [Select, "Organization") 

♦ Perform Script [Sub-scripts, External: "Capper") 

♦ Paste [Select, "Organization") 

♦ Copy [Select, "Location") 

♦ Perform Script [Sub-scripts, External' "Capper "] 

F 

Go to Lag out [...] 

Go to Record/Request [...] 

Go to Next Record/Request [...] 
Go to Previous Record/Request 
Go to Field [...] 

Go to Next Field 

Go to Previous Field 


■|ii ■; 

iijii 

li 5 

1^' 

Sort [...] 

Unsort 

Import Records [...] 

1 

♦ Paste [Select, "Location") 

♦ Copy [Select, "Street") 

♦ Perform Script [Sub-scripts, External: "Capper") 

M 

Import Picture... 



Import Movie... 

Export Records [...] 

i!i; 1 


Page Setup [...] 

Print [...] 


15^ Perform sub-scripts Specify : External Script... 



□ 


3 
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The home file for this demonstration I 
called Address Master. It contains all the nor¬ 
mal address fields, a bunch of calculations, and 
several scripts. I added a new script called 
MAKE FIVE CAPS. Since I decided to initiate the 
script with a layout button, I did not include 

MAKE FIVE CAPS in the Scripts menu. 

The MAKE FIVE CAPS Script has three steps 
for each field that I want to capitalize (five fields 
in this case): 

1) Copy the contents of the designated field in 
Address Master to the clipboard. 

2) Perform the pastein/copyout script in the 
Capper file. 

3) Paste the clipboard into the same field in 
Address Master as in step 1. 

Since after step 2 the data has been capital¬ 
ized in the Capper file, the data pasted back 
into the field in step three is the capitalized 
version of the data copied in step 1. 

I tried the script on one field and it worked. 
The next task was to expand the make five 


I CAPS script to include the address fields I nor- 
I mally want to capitalize. The Figure on the 
I previous page shows the completed script ex- 
I cept there is not room in the window for the 
I very last step which is to paste back into the 

j Street field. (That step does show up in the 
I Figure below.) 

I If Capper is already open it takes about 6 

I 

I seconds to capitalize five fields on a Mac Quad- 
i ra 900 using FileMaker Pro 2.1 (about 12 sec- 
j onds on a Mac Ilci). This is slow enough so 
I that you won’t want to use it for large quanti- 

I ties of records. If there was a way for a script to 

I test for no data, the empty fields could be 
j skipped, probably making the script quite a bit 
I faster. However, I could not find a way to do 
I such a test. One day if we get conditional 

I branching in scripts we should be able to speed 

I this one up. 

I 

J Note that because the clipboard is used as 
I the intermediary between the two files, the two 
I interacting scripts are really independent of 


Script Definition for “Make Fiue CflPs Set” 


Available Steps _"Make Five CAPs Set" 


Perform Script [...] 


♦ Copy [Select, "LastName"] 

Pi 

Pause/Resume Script 

1 

♦ Perform Script [Sub-scripts, External: "Capper"] 

w 



♦ Paste [Select, "LastName"] 


Go to Layout [...] 

iijii 

♦ Copy [Select, "Organization") 

*••••• 

Go to Record/Request [...] 

9i 

♦ Perform Script [Sub-scripts, External: "Capper"] 

mt 

Go to Next Record/Request [...] 

Ml 

♦ Paste [Select, "Organization"] 


Go to Previous Record/Request 

ilp: 

♦ Copy [Select, "Location"] 

ijilii 

Go to Field [...] 

ijili 

♦ Perform Script [Sub-scripts, External: "Capper"] 


Go to Next Field 

iilji 

♦ Paste [Select, "Location"] 


Go to Previous Field 


♦ Copy [Select, "Street"] 



ijilii 

♦ Perform Script [Sub-scripts, External: "Capper"] 


Sort [...] 


♦ Paste [Select, "Street"] 


Unsort 

=:P‘: 

♦ Go to Next Record/Request [Exit script after last] 


Import Records [...] 

iilH 

* Perform Script [Sub-scripts. " Make Five CAPs Se+ "] 


Import Picture... 



Import Movie... 




Export Records [...] 




Page Setup [...] 

Print [...] 

■ 

^ Perform sub-scripts Specify: Make Five CAPs Set^lj 




[ Clear Rll Clear 

1 




_ / 
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each other. Thus, if field names are changed in 
either file the process still works. 

I normally want to change only one record 
at a time — usually as I run across it. But some¬ 
times I want to capitalize a found set of records. 
In that case a different script is needed. The 
Figure on the previous page shows a new script 
that is the same as make five caps, except for 
two new steps at the end. The “Go To Next 
Record”step takes us to the next record in the 
found set after the last of the five fields in the 
current record has been capitalized. This step 
has a nice option that says to stop when there 
are no more records in the set. The following 
step then simply starts the script over again so 
that it processes the next record. Yes, FileMak¬ 
er scripts can call themselves. 

Notice that the iterative version of the 
script also works fine when there is only one 
record in the found set. Thus, if you don’t need 
to capitalize only one record in a set of several, 
you won’t need two scripts—just use the long¬ 
er version. 


I find it convenient to trigger my capitaliza¬ 
tion scripts by clicking on buttons (I use quite a 
few buttons when processing addresses). I 
often use graphics for buttons but for capitali¬ 
zation I use layout text as instead. The Figure 
below shows a blow-up of a part of a main 
address layout with two buttons just above the 
Last Name field. 

I hope this external function example is 
both useful in itself and helps as well to com¬ 
municate the underlying idea. Let me know if 
you find different and/or better ways to exploit 
this kind of structure. 


I 

I 

I 

I 

I Tip for building scripts 

In the case of a script Like the one on page 
14, it is not necessary to build the script ele¬ 
ments in the order they will be 



used — it takes a lot of scrolling 
up and down in the “Available 
Steps” box to do so. Instead, 
for repetitive scripts, I find one 
of the desired steps and then 
move the number I’m going to 
need (five in this case) into the 
script sequence box. Then I 
can locate the next step needed 
and move five of them, and so 
forth. At that point I can per¬ 
sonalize each step for the fields 
or actions desired and then 
drag them into place so the 
sequence is proper. Saves a lot 
of time. 
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